Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Editing Movies / Editing Movies

PutMovieOnScrap

The PutMovieOnScrap function allows your application to place a movie onto the scrap.

pascal OSErr PutMovieOnScrap (Movie theMovie, 
                              long movieScrapFlags);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

movieScrapFlags

Flags that control the operation. The following flags are available (set unused flags to 0):

movieScrapDontZeroScrap

Controls whether the Movie Toolbox clears the scrap before putting the movie on the scrap. If you set this flag to 1, the Movie Toolbox does not clear the scrap before placing your movie onto this scrap, thus adding your movie to the previous contents of the scrap. If you set this flag to 0, the function clears the scrap, then places your movie
on the scrap.

movieScrapOnlyPutMovie

Controls whether the Movie Toolbox places other items on the scrap along with your movie. If you set this flag to 1, the Movie Toolbox only places your movie on the scrap. If you set this flag to 0, the Movie Toolbox places an image from the current movie time (including but not limited to a PICT) on the scrap along with your movie. The picture is intended for use by applications that cannot work
with movies.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

Image Compression Manager errors
Memory Manager errors